@coral-xyz/anchor

@coral-xyz/anchor

TypeScript client for Anchor programs.

Note

• @coral-xyz/anchor depends on node.js native modules. Therefore, webpack 5 will not work with current version. You will either need to rollback to webpack 4, or use a polyfill for each missing dependency.

Changelog

[0.29.0] - 2023-10-16

See the Anchor 0.29 release notes for a high-level overview of how to update.

Features

• lang: Change all accounts to have a reference to AccountInfo (#2656).
• lang: Add get_lamports, add_lamports and sub_lamports methods for all account types (#2552).
• client: Add a helper struct DynSigner to simplify use of Client<C> where <C: Clone + Deref<Target = impl Signer>> with Solana clap CLI utils that loads Signer as Box<dyn Signer> (#2550).
• lang: Allow CPI calls matching an interface without pinning program ID (#2559).
• cli, lang: Add IDL generation through compilation. anchor build still uses parsing method to generate IDLs, use anchor idl build to generate IDLs with the build method (#2011).
• avm: Add support for the .anchorversion file to facilitate switching between different versions of the anchor-cli (#2553).
• ts: Add ability to access workspace programs independent of the casing used, e.g. anchor.workspace.myProgram, anchor.workspace.MyProgram... (#2579).
• bench: Add benchmarking for program binary size (#2591).
• spl: Export mpl-token-metadata crate (#2583).
• spl: Add TokenRecordAccount for pNFTs (#2597).
• ts: Add support for unnamed(tuple) enum in accounts (#2601).
• cli: Add program template with multiple files for instructions, state... (#2602).
• bench: Add benchmarking for stack memory usage (#2617).
• lang: Box the inner enums of anchor_lang::error::Error to optimize anchor_lang::Result (#2600).
• ts: Add strong type support for Program.addEventListener method (#2627).
• syn: Add IdlBuild trait to implement IDL support for custom types (#2629).
• spl: Add idl-build feature. IDL build method will not work without enabling this feature when using anchor-spl (#2629).
• lang: Add support for type aliases in IDLs (#2637).
• cli: Add test.upgradeable, test.genesis.upgradeable setting in Anchor.toml to support testing upgradeable programs (#2642).
• cli, client, lang, spl: Update Solana toolchain and dependencies to 1.17.0, 1.16 remains supported (#2645).
• spl: Add support for memo program (#2661).
• avm: Add anchor-cli installation from commit (#2659).
• cli: Add toolchain property in Anchor.toml to override Anchor and Solana versions (#2649).

Fixes

• ts: Packages no longer depend on assert (#2535).
• lang: Support for const in the InitSpace macro (#2555).
• cli: Support workspace inheritance (#2570).
• client: Compile with Solana 1.14 (#2572).
• cli: Fix anchor build --no-docs adding docs to the IDL (#2575).
• ts: Load workspace programs on-demand rather than loading all of them at once (#2579).
• lang: Fix associated_token::token_program constraint (#2603).
• cli: Fix anchor account command panicking outside of workspace (#2620).
• lang: IDL named enum variant fields are now camelCase as opposed to snake_case, consistent with the other IDL types (#2633).
• avm: Remove excessive panics and handle the errors gracefully (#2671).

Breaking

• lang: Switch to type safe bumps in context (#2542).
• syn: idl feature has been replaced with idl-build, idl-parse and idl-types features (#2011).
• syn: IDL parse method now returns Result<Idl> instead of Result<Option<Idl>> (#2582).
• spl: Update mpl-token-metadata dependency to use the client SDK instead of the program crate (#2632).
• ts: Remove base64-js dependency (#2635).
• syn: IdlTypeDefinitionTy enum has a new variant Alias (#2637).
• cli, client, lang, spl: Solana 1.14 is no longer supported, minimum required Solana version is 1.16.0 (#2645).
• cli: anchor_version and solana_version property in Anchor.toml that was being used in verifiable builds are moved inside toolchain. They are now being used for all commands in the workspace, not just verifiable builds (#2649).